PathTools - Simple Utility for Viewing/Manipulating SC4PATH files
=================================================================

Background
==========
I wrote this little utility for myself to help with the pathing for a custom lot I was helping with. I figured it was worth tidying up and making available.

Hope it helps a few people.

Chris (cjmarshall@bigfoot.com)

Licence
=======
This program is too small to be worth writing a full EULA for so consider it released under the GPL for now. Contact me if this causes any problems.

Credits
=======
Thanks to the Simtropolis Modd Squad for discovering the Path file format and to Redlotus in particular for documenting it in his excellent intersection tutorial.

Installation
============
Just copy the EXE somewhere and run it.

If it doesn't run at all you probably need one or both of :
1. The VB6 runtimes from
http://www.microsoft.com/downloads/details.aspx?FamilyID=bf9a24f9-b5c5-48f4-8edd-cdf2d29a79d5&displaylang=en

2. The scripting runtimes from
http://msdn.microsoft.com/library/default.asp?url=/downloads/list/webdev.asp

Instructions
============

Panel 1 - Path File Data
------------------------
This panel provides for transferring path file data to/from PathTools using the clipboard, and for editing the text of the path file itself.

Path files are transferred to/from PathTools by using the clipboard as this enabled reasonably quick workflow when working with iLive's reader. Allowing PathTools to access the DAT files themselves would have been far too much work to implement.

This panel contains a text box where the Path file text can be edited and 3 buttons whose functions are as follows :
- Paste
Paste text from the clipboard into the Path file edit box

- Copy
Copy text from the path file edit box to the clipboard

- Read
Read in the path file data into the internal data structures used for displaying the plot and providing rudimentary editing. Attempts to round trip the data by regenerating the Path File Text from the internal data structures. If the round-tripped data differs significantly from the original then a warning is displayed allowing a choice of whether to allow the write-back. This prevents loss of data when the path or stop count hasn't been updated for example.


Panel 2 - Plot
--------------
This panel provides a graphical view of the data in the path file. Paths are drawn in various colours depending on the transport type to which they apply. Circles are drawn at the start of each path. Stop points are drawn as 'crossed-boxes'. Labels on each side of the plot indicate the side numbers. The radio buttons surrounding the plot allow choice of orientation. The 'UK' check box causes the car paths to be plotted as they will behave on the UK version of the game (car path directions reversed, UK rather than normal stop points active).


Panel 3 - Paths
---------------
Lists the paths in the file (using the first comment line as a label). These can be selected in the list, which causes them to be plotted in red. Four buttons alongside provide the following simple operations :
- Remove
Delete any selected paths

- Reverse
Reverse the direction of selected paths

- XMirror
Mirror the selected paths about the Y axis (ie reverse the X coordinates).

- Rotate 90C
Rotate the selected paths clockwise by 90 degrees about the origin (path file centre).


Panel 4 - Stops
---------------
Lists the stop points in the file (using the first comment line as a label). These can be selected in the list and will be plotted in red. The 3 buttons alongside allow the following operations :
- Remove
Delete the selected stop points

- XMirror
Reverse the X coordinates of the selected stop points (i.e mirror about the Y axis)

- Rotate 90C
Rotate the coordinates of the selected stop points 90 degrees about the origin (path file centre).


